home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / diskutil / memfile.lzh / MEMFIL20.DOC < prev    next >
Text File  |  1988-08-20  |  19KB  |  328 lines
  1. 8/19/88
  2.  
  3.             MemFile 2.0, Copyright 1988 by Dan Wilga. All rights reserved.
  4.  
  5.  
  6.           This program and its resource file may be freely distributed on
  7.           the conditions that a copy of this DOC file is included and no
  8.           payment of any type (including "copying" fees) is incurred upon
  9.           the recipient of the program. No warranty is made as to the
  10.           compatibility of this program and the author cannot be considered
  11.           responsible for any loss of data which results from the use of
  12.           this program. Use it at your own risk!
  13.  
  14.  
  15. | Revisions to Version 1.4:
  16. |     Bug Fixes:
  17. |         []  Window redraws oftentimes were not preformed correctly when
  18. |             the MemFile window was not the topmost.
  19. |         []  A minor change to the way in which it is decided when to
  20. |             display the "These addresses might not be alterable" message.
  21. |         []  Displaying addresses greater than six digits resulted in
  22. |             garbage in the address column of the display.
  23. |         []  The title bar is reset when changing to another editor type.
  24. |             Previously, the results of a Search would be left displayed.
  25. |     Enhancements:
  26. |         []  All graphics routines have been converted to the smaller and
  27. |             faster "linea" type.
  28. |         []  Thanks to Mark Williams' VSMALL option, the code is much smaller.
  29. |             Guess that's why they called it that, eh?
  30. |         []  Many of the features can be activated with a single keystroke,
  31. |             and no longer require the mouse. This includes an automatic
  32. |             repeat for the scroll bar functions. A keymap is available.
  33. |         []  Decimal and hexadecimal offsets can now be entered in any of
  34. |             the three editing modes, not just for Memory. Also, after they
  35. |             have been entered, the value in the editable field is no
  36. |             longer updated to that of the lowest address in the display.
  37. |             I suppose it might get confusing, but I got tired of it the
  38. |             other way.
  39. |         []  The editor makes better use of the numeric keypad. See below.
  40. |         []  The Search feature now posts a message in the title bar of
  41. |             the window if the search has gone past phystop.
  42. |         []  Search also can optionally produce a bell tone after the search
  43. |             has ended for any reason other than the user cancelling. This
  44. |             tone continues every few seconds until a mouse button or key
  45. |             is pressed.
  46. |         []  The location in memory where the actual string being searched
  47. |             for is located no longer stops the search when it is encountered.
  48. |         []  This document has been updated. Changes are denoted by a "|"
  49. |             in the first column.
  50.  
  51.  
  52.   Overview:
  53.  
  54.           MemFile is a desk accessory (DA) program that allows the user to view
  55.   and edit any portion of his ST's memory, a file on any disk drive or the
  56.   individual sectors of any drive. Because it is a desk accessory, it has the
  57.   added advantage that it is available from any GEM application, so you can
  58.   easily call it up if, say for instance, you are debugging a program and you
  59.   want to make sure that it has written a file correctly without having to leave
  60.   the program you are working on. It is also a moveable window which means that
  61.   you can reposition it to another location on the screen or even click on
  62.   another open window.
  63.           The current MemFile package includes the following files:
  64.           
  65. |              MEMFIL20.DOC -- You're reading it
  66. |              MEMFIL20.ACC -- The program
  67. |              MEMFIL20.RSC -- The program's resource file
  68.  
  69.  
  70.   Installation:
  71.  
  72.          MemFile is installed just like any other DA; place the files
  73. | MEMFIL20.ACC and MEMFIL20.RSC in the root directory of the disk drive you
  74.   normally boot from and hit the reset button on the back of your machine.
  75.  
  76.  
  77.   General Use:
  78.  
  79.           When you select the "MemFile!" item from the desktop's menu bar, a
  80.   window appears. When you use MemFile for the first time after booting, the
  81.   program displays the contents of your machine's memory starting at the bottom
  82.   of memory (address 0). At this time you can click on either of the two buttons
  83.   on the right side of the dialog to toggle between hexadecimal or decimal
  84.   addresses. You can also click on either of the other two buttons labeled
  85.   "File" and "Sector" to switch the display to those functions.
  86.           Which ones of the other buttons are valid depends upon the mode you
  87.   are in: if you are in Memory, you can click on either the editable address in
  88.   hex or decimal, but you cannot click on any of the buttons underneath these
  89.   two without switching modes.
  90.           You can edit the information contained in the display by clicking on
  91.   either the two-digit bytes in the second column or their ASCII representation
  92.   in the third column of the display. A cursor will appear, which can be moved
  93.   with the arrow keys. When you are editing the bytes, only the 0-9, a-f
  94. | (or A-F) keys will have any effect. You can either use the keys that appear
  95. | on the main keyboard for this or the ones on the numberic keypad. The hex
  96. | letters A-F can also be entered on the keypad by referring to the follwing
  97. | diagram:
  98. |
  99. |        --- --- --- ---
  100. |       | A | B | C | D |
  101. |        --- --- --- ---
  102. |       | 7 | 8 | 9 | E |
  103. |        --- --- --- ---
  104. |       | 4 | 5 | 6 | F |
  105. |        --- --- --- ---
  106. |       | 1 | 2 | 3 |Ent|
  107. |        ------- ---|   |
  108. |       | 0     |###|   |    Note: The decimal key is unused in this mode.
  109. |        ------- --- ---
  110. |
  111. | When editing the ASCII values contained in the second column, you can enter
  112. | anything, including control characters. When you are done editing, hit the
  113.   Return key. A dialog asking if you want to rewrite the information will
  114.   appear. Click on "Yes" only if you are certain that the changes you have made
  115.   are correct, otherwise you may damage system memory, forcing you to re-boot
  116.   or, worse, damage important information on a disk.
  117.           Normally, the ASCII column of the display contains all the individual
  118.   characters that make up the area being viewed. The one exception to this is
  119.   the NUL character (0x00) which cannot normally be displayed. MemFile shows
  120.   a decimal point (".") in any location where a NUL should be. Please be aware
  121. | that if you attempt to edit the ASCII column, the only way to actually enter
  122. | a true NUL character is with the decimal key ON THE KEYPAD. Do NOT enter
  123. | a decimal point from the main keyboard if what you want is a NUL! The
  124. | surest way to change a byte to a NUL is to change its value in the Hex
  125.   column to zero instead.
  126.  
  127.  
  128.   The Search Feature:
  129.   
  130.           The "Search" button calls-up a dialog which allows you to search for
  131.   a string of characters within the area that is currently being displayed.
  132.   Click on either the ASCII or the Hex box, depending upon how you want to
  133.   enter the string. After you have clicked on one or the other the cursor
  134.   will appear on the field you selected, allowing you to edit the information
  135.   there. The ASCII field may contain any key that can be typed on the keyboard.
  136.   The Hex field, however, must only contain the digits 0-9 and A-F (or
  137.   lowercase a-f).
  138. |         The other option you have here is to specify whether or not you
  139. | want to be alerted when the search has completed. If you select "On", a
  140. | bell tone will be produced when the search has finished, assuming you did
  141. | not cancel the search part way through. The tone will continue to sound
  142. | every few seconds, but can be stopped by pressing a key, the left mouse
  143. | button, or performing a window operation. This feature was intended to allow
  144. | you to do something else (dare I say it?) away from the computer while
  145. | a lengthy search is being performed.
  146.           When you have finished editing the field you chose, click on the
  147.   "Done!" button at the bottom of the dialog. The search will then begin. You
  148.   should see the scroll bar move as the